home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / rcsclean.1 < prev    next >
Text File  |  1995-07-25  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. RCSCLEAN(1)                                           RCSCLEAN(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rcsclean - clean up working files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrccsscclleeaann [_o_p_t_i_o_n_s] [ _f_i_l_e ... ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        rrccsscclleeaann  removes  working files that were checked out and
  15.        never modified.  For each _f_i_l_e  given,  rrccsscclleeaann  compares
  16.        the  working  file and a revision in the corresponding RCS
  17.        file.  If it finds a difference, it does nothing.   Other-
  18.        wise,  it  first  unlocks the revision if the --uu option is
  19.        given, and then removes the working file unless the  work-
  20.        ing  file is writable and the revision is locked.  It logs
  21.        its actions by outputting the corresponding rrccss --uu and  rrmm
  22.        --ff commands on the standard output.
  23.  
  24.        If  no  _f_i_l_e  is  given,  all working files in the current
  25.        directory are cleaned.  Pathnames matching an  RCS  suffix
  26.        denote  RCS files; all others denote working files.  Names
  27.        are paired as explained in ccii(1).
  28.  
  29.        The number of the revision to which the  working  file  is
  30.        compared may be attached to any of the options --nn, --qq, --rr,
  31.        or --uu.  If no revision number is specified, then if the --uu
  32.        option  is  given  and the caller has one revision locked,
  33.        rrccsscclleeaann uses that revision; otherwise rrccsscclleeaann  uses  the
  34.        latest  revision on the default branch, normally the root.
  35.  
  36.        rrccsscclleeaann is useful for cclleeaann targets  in  Makefiles.   See
  37.        also  rrccssddiiffff(1),  which  prints  out the differences, and
  38.        ccii(1), which normally asks whether to check in a  file  if
  39.        it was not changed.
  40.  
  41. OOPPTTIIOONNSS
  42.        --kk_s_u_b_s_t
  43.               Use  _s_u_b_s_t style keyword substitution when retriev-
  44.               ing the revision for  comparison.   See  ccoo(1)  for
  45.               details.
  46.  
  47.        --nn[_r_e_v]
  48.               Do  not  actually  remove  any  files or unlock any
  49.               revisions.  Using this option will  tell  you  what
  50.               rrccsscclleeaann would do without actually doing it.
  51.  
  52.        --qq[_r_e_v]
  53.               Do not log the actions taken on standard output.
  54.  
  55.        --rr[_r_e_v]
  56.               This option has no effect other than specifying the
  57.               revision for comparison.
  58.  
  59.        --uu[_r_e_v]
  60.               Unlock  the  revision  if  it  is  locked  and   no
  61.  
  62.  
  63.  
  64. GNU                         1991/11/03                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCSCLEAN(1)                                           RCSCLEAN(1)
  71.  
  72.  
  73.               difference is found.
  74.  
  75.        --VV_n    Emulate RCS version _n.  See ccoo(1) for details.
  76.  
  77.        --xx_s_u_f_f_i_x_e_s
  78.               Use  _s_u_f_f_i_x_e_s to characterize RCS files.  See ccii(1)
  79.               for details.
  80.  
  81. EEXXAAMMPPLLEESS
  82.               rrccsscclleeaann  **..cc  **..hh
  83.  
  84.        removes all working files ending in ..cc or ..hh that were not
  85.        changed since their checkout.
  86.  
  87.               rrccsscclleeaann
  88.  
  89.        removes  all  working  files in the current directory that
  90.        were not changed since their checkout.
  91.  
  92. FFIILLEESS
  93.        rrccsscclleeaann accesses files much as ccii(1) does.
  94.  
  95. EENNVVIIRROONNMMEENNTT
  96.        RRCCSSIINNIITT
  97.               options prepended to the argument  list,  separated
  98.               by  spaces.   A  backslash escapes spaces within an
  99.               option.  The RRCCSSIINNIITT options are prepended  to  the
  100.               argument   lists  of  most  RCS  commands.   Useful
  101.               RRCCSSIINNIITT options include --qq, --VV, and --xx.
  102.  
  103. DDIIAAGGNNOOSSTTIICCSS
  104.        The exit status is zero if and only if all operations were
  105.        successful.   Missing  working  files  and  RCS  files are
  106.        silently ignored.
  107.  
  108. IIDDEENNTTIIFFIICCAATTIIOONN
  109.        Author: Walter F. Tichy.
  110.        Revision Number: 1.8; Release Date: 1991/11/03.
  111.        Copyright (C) 1982, 1988, 1989 by Walter F. Tichy.
  112.        Copyright (C) 1990, 1991 by Paul Eggert.
  113.  
  114. SSEEEE AALLSSOO
  115.        ci(1), co(1), ident(1), rcs(1),  rcsdiff(1),  rcsintro(1),
  116.        rcsmerge(1), rlog(1), rcsfile(5)
  117.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  118.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e  _&  _E_x_p_e_r_i_e_n_c_e  1155,  7   (July   1985),
  119.        637-654.
  120.  
  121. BBUUGGSS
  122.        At  least  one  _f_i_l_e  must be given in older Unix versions
  123.        that do not provide the needed directory  scanning  opera-
  124.        tions.
  125.  
  126.  
  127.  
  128.  
  129.  
  130. GNU                         1991/11/03                          2
  131.  
  132.  
  133.